home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / wildcat / avu1r6.zip / AVU.DOC next >
Text File  |  1996-05-27  |  5KB  |  128 lines
  1. AVU - archive viewing utility for Wildcat 4.1x - VIEWCOMP.WCX
  2. ----------------------------------------------------------------------------
  3.  
  4. Version 1.6   27/5/96 Compiled with wcCode 4.12
  5.  
  6. About..
  7. ─────
  8.  
  9. See HISTORY.TXT for revision history!
  10.  
  11. Well, i got fed up with VZ that came with Wildcat. It's ok, but not
  12. wonderful. I also got p*ssed off with shareware, nagware, crippleware,
  13. beerware, expireware, charityware archive viewers at ONLY $60 etc,
  14. so i wrote my own.
  15.  
  16. I also hate programs that advertise other BBSes - especially if it comes
  17. from somewhere like "The Grunting Dog BBS" - looks REALLY impressive when
  18. your main sponsor logs on and sees software supplied by ..well, you know!
  19. so there's NO advertising, copyrights etc in it - only in the DOCS and the
  20. source..
  21.  
  22. This is a stable version, and is released into the public domain as freeware.
  23. All the source is commented. If you modify the source and redistribute it,
  24. PLEASE make a note of what you did and who you are, in the source. Thanks!
  25.  
  26. Installation:
  27. ────────────
  28. 1. Unzip viewcomp.wcx into your Wildcat directory;
  29. 2. Run UNZ512X.exe in a temporary directory (self-extracting ZIP)
  30. 3. Copy unzip.exe to a directory in your path. You CAN'T use PKUNZIP.
  31. 4. You need a single work area for this utility:
  32.  
  33.     In your AUTOEXEC.BAT, you must have either:
  34.  
  35.         SET TEMP=x:\somewhere
  36.         or
  37.         SET AVU=x:\somewhere
  38.  
  39.     It will use the drive/directory pointed to by AVU in preference.
  40.  
  41.     Where x: is a real drive letter and \somewhere is a real directory.
  42.     Trailing "\" is optional - the program will sort it out.
  43.  
  44.     If you are rich, and have a BIG ram drive, you could always point
  45.     AVU to that for REAL speed! This is where the display limit comes in
  46.     useful - if your RAM disk is say 512K, you can have a display limit
  47.     of say, 500K !
  48.  
  49.     NB: if the directory doesn't exist, VIEWCOMP will not create it!
  50.         you should have TEMP defined though..
  51.  
  52. 5.  If you want to limit the number of bytes that a caller can display
  53.     (to save someone viewing a 3Mb text file online!) simply create a
  54.     file named VIEWCOMP.CFG in the same directory as VIEWCOMP.WCX, and
  55.     enter the number of bytes that you wish as a maximum: i.e
  56.  
  57.     500000
  58.  
  59.     will beep at the caller and stop the display when that number of
  60.     bytes has been reached.
  61.  
  62.  
  63.     Two typical example VIEWCOMP.CFG files:
  64.  
  65.     200000              ;display maximum of 200,000 bytes
  66.     100                 ;extract files to filearea 100
  67.     0                   ;don't password protect extracted files
  68.     SUBSCRIBER SYSOP    ;these sec levels can download
  69.  
  70.     99999999            ;(theoretically) unlimited display maximum
  71.     100                 ;extract files to filearea 100
  72.     -1                  ;password protect extracted files
  73.     *                   ;everyone can download
  74.  
  75.     If you do make a config file, DON'T PUT THE ;COMMENTS IN !!!!!
  76.  
  77. 6. Once you have installed it, run it from your local node to make sure
  78.    it acts like you expect it to..!
  79.  
  80.  
  81. Running it:
  82. ──────────
  83. This will be run when you (V)iew a file from your FILES menu instead of
  84. Viewcomp.bat.
  85.  
  86. It will work on text files with .TXT extension and .ZIP files at the moment.
  87. If you point it an .EXE file, it will check to see if it can find a ZIP in
  88. there - if found, it will display it.
  89.  
  90. It's choosy about what types of files it will display. The list isn't
  91. comprehensive though. If it displays program files strange things may happen
  92. on your display, although the program won't be affected. See the source for
  93. file extensions it will and won't display.
  94.  
  95. It should be multi-node aware - all the work files have unique names.
  96.  
  97. It deletes it's work files on exit (and on entry if they exist!)
  98.  
  99. What it won't do:
  100. ────────────────
  101.  
  102. Intelligently determine whether a file is binary or non-binary (adds a
  103. HUGE overhead as it has to open/read-a-little/close each file the caller
  104. selects). Let me think about this one..
  105.  
  106. Other things:
  107. ────────────
  108.  
  109. No responsibility for ANY damage caused! I won't be responsible if it
  110. writes huge files and fills your hard disk. However, it works fine for me!
  111.  
  112. Displays full pathname of stored file(s) if applicable. They will probably
  113. wrap round and spoil the display if they are too long.. I'm working on this.
  114.  
  115. I use UNZIP in preference to PKUNZIP as:
  116.  
  117.     * it's free (subject to conditions)
  118.     * you can select ultra-quiet operation on unzipping with no copyright
  119.       info filling the file, unlike PKunzip.
  120.     * it works fine under OS/2 Warp, but then, don't most things <g>
  121.  
  122. I would appreciate comments etc:
  123.  
  124.     * call Mildew Hall on +44 (0)1420-543542  or
  125.     * email sysop@mildewh.dircon.co.uk  or
  126.     * messages in .. MSI-UK Wildcat Sysops,  MSI-World Wildcat
  127.  
  128.